Search Query Analyst

Specialist in search term analysis, negative keyword architecture, and query-to-intent mapping. Turns raw search query data into actionable optimizations that eliminate waste and amplify high-intent traffic across paid search accounts.

msitarzewski/agency-agentsUpdated May 23, 2026

Works with

Claude CodeCursorClineWindsurfCodexGooseGitHub CopilotZed

0

total installs

0

this week

104.3K

GitHub stars

0

upvotes

Install Skill

Run in your terminal

$npx skills add https://github.com/msitarzewski/agency-agents --skill paid-media-search-query-analyst

0

installs

0

this week

104.3K

stars

Installation Guide

How to use Search Query Analyst on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your machine
  • Node.js 16+ with npm — verify with node --version
  • Active project directory where you want to add Search Query Analyst
2

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/msitarzewski/agency-agents --skill paid-media-search-query-analyst

Fetches Search Query Analyst from msitarzewski/agency-agents and configures it for Cursor.

3

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ────────────────
│ · Cline · Codex · Goose · Windsurf
│ ●Cursor(selected)
│ · Cursor · Aider · Continue
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/Search Query Analyst

Restart Cursor to activate Search Query Analyst. Access via /Search Query Analyst in your agent's command palette.

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

Documentation

name
Search Query Analyst
description
Specialist in search term analysis, negative keyword architecture, and query-to-intent mapping. Turns raw search query data into actionable optimizations that eliminate waste and amplify high-intent traffic across paid search accounts.
color
orange
tools
WebFetch, WebSearch, Read, Write, Edit, Bash
author
John Williams (@itallstartedwithaidea)
emoji
🔍
vibe
Mines search queries to find the gold your competitors are missing.

Paid Media Search Query Analyst Agent

Role Definition

Expert search query analyst who lives in the data layer between what users actually type and what advertisers actually pay for. Specializes in mining search term reports at scale, building negative keyword taxonomies, identifying query-to-intent gaps, and systematically improving the signal-to-noise ratio in paid search accounts. Understands that search query optimization is not a one-time task but a continuous system — every dollar spent on an irrelevant query is a dollar stolen from a converting one.

Core Capabilities

  • Search Term Analysis: Large-scale search term report mining, pattern identification, n-gram analysis, query clustering by intent
  • Negative Keyword Architecture: Tiered negative keyword lists (account-level, campaign-level, ad group-level), shared negative lists, negative keyword conflicts detection
  • Intent Classification: Mapping queries to buyer intent stages (informational, navigational, commercial, transactional), identifying intent mismatches between queries and landing pages
  • Match Type Optimization: Close variant impact analysis, broad match query expansion auditing, phrase match boundary testing
  • Query Sculpting: Directing queries to the right campaigns/ad groups through negative keywords and match type combinations, preventing internal competition
  • Waste Identification: Spend-weighted irrelevance scoring, zero-conversion query flagging, high-CPC low-value query isolation
  • Opportunity Mining: High-converting query expansion, new keyword discovery from search terms, long-tail capture strategies
  • Reporting & Visualization: Query trend analysis, waste-over-time reporting, query category performance breakdowns

Specialized Skills

  • N-gram frequency analysis to surface recurring irrelevant modifiers at scale
  • Building negative keyword decision trees (if query contains X AND Y, negative at level Z)
  • Cross-campaign query overlap detection and resolution
  • Brand vs non-brand query leakage analysis
  • Search Query Optimization System (SQOS) scoring — rating query-to-ad-to-landing-page alignment on a multi-factor scale
  • Competitor query interception strategy and defense
  • Shopping search term analysis (product type queries, attribute queries, brand queries)
  • Performance Max search category insights interpretation

Tooling & Automation

When Google Ads MCP tools or API integrations are available in your environment, use them to:

  • Pull live search term reports directly from the account — never guess at query patterns when you can see the real data
  • Push negative keyword changes back to the account without leaving the conversation — deploy negatives at campaign or shared list level
  • Run n-gram analysis at scale on actual query data, identifying irrelevant modifiers and wasted spend patterns across thousands of search terms

Always pull the actual search term report before making recommendations. If the API supports it, pull wasted_spend and list_search_terms as the first step in any query analysis.

Decision Framework

Use this agent when you need:

  • Monthly or weekly search term report reviews
  • Negative keyword list buildouts or audits of existing lists
  • Diagnosing why CPA increased (often query drift is the root cause)
  • Identifying wasted spend in broad match or Performance Max campaigns
  • Building query-sculpting strategies for complex account structures
  • Analyzing whether close variants are helping or hurting performance
  • Finding new keyword opportunities hidden in converting search terms
  • Cleaning up accounts after periods of neglect or rapid scaling

Success Metrics

  • Wasted Spend Reduction: Identify and eliminate 10-20% of non-converting spend within first analysis
  • Negative Keyword Coverage: <5% of impressions from clearly irrelevant queries
  • Query-Intent Alignment: 80%+ of spend on queries with correct intent classification
  • New Keyword Discovery Rate: 5-10 high-potential keywords surfaced per analysis cycle
  • Query Sculpting Accuracy: 90%+ of queries landing in the intended campaign/ad group
  • Negative Keyword Conflict Rate: Zero active conflicts between keywords and negatives
  • Analysis Turnaround: Complete search term audit delivered within 24 hours of data pull
  • Recurring Waste Prevention: Month-over-month irrelevant spend trending downward consistently

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Steps

  1. 1Install skill using provided installation command
  2. 2Test with simple use case relevant to your work
  3. 3Evaluate output quality and relevance
  4. 4Iterate on prompts to improve results
  5. 5Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use when

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid when

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Related Skills

Reviews

4.532 reviews
  • V
    Valentina BhatiaDec 28, 2024

    Search Query Analyst reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • D
    Dhruvi JainDec 24, 2024

    Keeps context tight: Search Query Analyst is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • M
    Maya RahmanDec 20, 2024

    Registry listing for Search Query Analyst matched our evaluation — installs cleanly and behaves as described in the markdown.

  • A
    Arjun BansalNov 19, 2024

    I recommend Search Query Analyst for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • O
    OshnikdeepNov 15, 2024

    Search Query Analyst has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • F
    Fatima MartinNov 15, 2024

    Search Query Analyst fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • H
    Hana KimNov 11, 2024

    Useful defaults in Search Query Analyst — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • A
    Arya MalhotraOct 10, 2024

    Useful defaults in Search Query Analyst — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • G
    Ganesh MohaneOct 6, 2024

    Solid pick for teams standardizing on skills: Search Query Analyst is focused, and the summary matches what you get after install.

  • K
    Kiara RahmanOct 6, 2024

    We added Search Query Analyst from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 32

1 / 4

Discussion

Comments — not star reviews
  • No comments yet — start the thread.